home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / tb042.zip / TB042.NEW < prev    next >
Text File  |  1992-07-07  |  3KB  |  65 lines
  1. Version 0.42 has some features that are not covered in the 0.40 manual.
  2. This document attempts to cover them in enough detail to enlighten TurBoard
  3. sysops on how to use them.
  4.  
  5. YAK
  6.  
  7. The additions to YAK include support for hotkey and hotspot menus.  A hotkey
  8. menu refers to a menu that accepts one-key input and will perform a
  9. sysop defined function when that key is hit.  A hotspot menu refers to a menu
  10. that accepts mouse point and click input and will perform a sysop defined
  11. function when type spot is selected.
  12.  
  13. There is a new YAK variable called "MENU" that TurBoard uses to keep up with
  14. what hotkey/spot menu is currently being displayed.  Every menu has a number
  15. associated with it.  For example:
  16.  
  17. Menu 0:  Frame showing choice between hotkey menus and command prompt.
  18. Menu 1:  Top menu for hotkey menus.
  19. Menu 2:  Hotkey menu showing all the message functions.
  20. Menu 3:  etc...
  21.  
  22. TurBoard always initializes the MENU variable to 0 whenever a new caller logs
  23. on.  To access this, YAK has a new check (16) that will compare the value of
  24. the menu variable to the check value in the YAK check record and pass true
  25. if they match.
  26.  
  27. There is a new command in TurBoard called MENU <value> that assigns a value
  28. via the command line to the internal menu variable.
  29.  
  30. This is how TurBoard changes hotkey menus to give the user the appearance of
  31. different menus and menu levels.  Taking the above example we could have a
  32. YAK record for the Menu 0 frame (choice between hotkey menus and command
  33. prompt) that looks something like this:
  34.  
  35. Name:  HOTCHOIC
  36. Check:  16 (0) <= This is a check saying that the menu variable is zero, so
  37.                   Lets display this yak file.
  38. Menu type: Hotkey
  39.  
  40. The hotkey and hotspot settings should be set to allow input corresponding
  41. to what your frame says.  For example, you may set up C to issue the command
  42. "MENU 35000" and M to issue the command "MENU 1".
  43.  
  44. "C" would set the internal menu variable to the value 35000.
  45. "M" would set the internal menu varialbe to the value 1, which would then be
  46. picked up by a YAK record with check 16 checkvalue 1.
  47.  
  48. Should you decide to perform one of the TurBoard functions with a hotkey or
  49. hotspot simply put the normal command line command as that command.
  50.  
  51. For example, if you have a menu with options to go to the art gallery or
  52. door menu, as A and D respectively, set the command for A as "A" and the
  53. command for D as "DO".
  54.  
  55.  
  56. To set hotspots on a TurBoard frame, use the mouse to actually set the spots,
  57. and where they reside.  Choose the set hotspot option from you YAK settings
  58. menu (you must have the menu type as "Hotkey") and then choose the set
  59. hotspot option.  You will be prompted to click on the upper left then the
  60. lower right corner of the NAPLPS "hot spot" for that command.
  61.  
  62. All your hot spots must be manually entered in this fashion, and keep in
  63. mind that hot-spots are only for NAPLPS frames, in ANSI or ASCII mode, mouse
  64. pointer clicks return the actual character to the command line or hotkey menu.
  65.